package cn.cjxy.springboot_zonghe_practice.controller;

import cn.cjxy.springboot_zonghe_practice.domain.Employee;
import cn.cjxy.springboot_zonghe_practice.query.BaseQuery;
import cn.cjxy.springboot_zonghe_practice.service.EmployeeService;
import cn.cjxy.springboot_zonghe_practice.utils.R;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.math.BigDecimal;
import java.util.List;

/**
 * 员工管理控制器
 * 提供员工相关的RESTful API接口
 * 包括员工的增删改查、分页查询、批量操作、统计查询等功能
 * 
 * @author huangjie
 * @since 2025-07-06
 */
@RestController
@RequestMapping("/employee")
public class EmployeeController {
    
    /**
     * 员工服务层
     */
    @Autowired
    private EmployeeService employeeService;

    /**
     * 添加员工
     * 
     * @param employee 员工信息对象（JSON格式）
     * @return 操作结果
     * 
     * @apiNote 请求示例：
     * POST /employee
     * {
     *   "name": "张三",
     *   "sex": 1,
     *   "age": 25,
     *   "idcard": "110101199001011234",
     *   "phone": "13800138000",
     *   "salary": 8000.00,
     *   "dept_id": 1
     * }
     */
    @PostMapping
    public R addEmployee(@RequestBody Employee employee) {
        return employeeService.addEmployee(employee);
    }

    /**
     * 修改员工信息
     * 
     * @param employee 员工信息对象（必须包含id）
     * @return 操作结果
     * 
     * @apiNote 请求示例：
     * PUT /employee
     * {
     *   "id": 1,
     *   "name": "张三",
     *   "sex": 1,
     *   "age": 26,
     *   "idcard": "110101199001011234",
     *   "phone": "13800138000",
     *   "salary": 8500.00,
     *   "dept_id": 1
     * }
     */
    @PutMapping
    public R updateEmployee(@RequestBody Employee employee) {
        return employeeService.updateEmployee(employee);
    }

    /**
     * 根据ID删除员工
     * 注意：有部门的员工不可以被删除
     * 
     * @param id 员工ID（路径参数）
     * @return 操作结果
     * 
     * @apiNote 请求示例：DELETE /employee/1
     */
    @DeleteMapping("/{id}")
    public R deleteEmployeeById(@PathVariable("id") Long id) {
        return employeeService.deleteEmployeeById(id);
    }

    /**
     * 根据ID查询员工信息
     * 
     * @param id 员工ID（路径参数）
     * @return 员工详细信息
     * 
     * @apiNote 请求示例：GET /employee/1
     */
    @GetMapping("/{id}")
    public R selectEmployeeById(@PathVariable("id") Long id) {
        return employeeService.selectEmployeeById(id);
    }

    /**
     * 分页查询员工
     * 
     * @param query 分页查询参数（currentPage: 页码, pageSize: 每页大小）
     * @return 分页结果，包含员工列表、总数、当前页码、每页大小
     * 
     * @apiNote 请求示例：GET /employee/page?currentPage=1&pageSize=10
     */
    @PostMapping("/page")
    public R selectEmployeeByPage(@RequestBody BaseQuery query) {
        return employeeService.selectEmployeeByPage(query);
    }

    /**
     * 批量添加员工
     * 
     * @param employees 员工列表（JSON数组格式）
     * @return 操作结果
     * 
     * @apiNote 请求示例：
     * POST /employee/batch
     * [
     *   {
     *     "name": "张三",
     *     "sex": 1,
     *     "age": 25,
     *     "idcard": "110101199001011234",
     *     "phone": "13800138000",
     *     "salary": 8000.00,
     *     "dept_id": 1
     *   },
     *   {
     *     "name": "李四",
     *     "sex": 2,
     *     "age": 28,
     *     "idcard": "110101199201011234",
     *     "phone": "13800138001",
     *     "salary": 9000.00,
     *     "dept_id": 2
     *   }
     * ]
     */
    @PostMapping("/batch")
    public R batchAddEmployee(@RequestBody List<Employee> employees) {
        return employeeService.batchAddEmployee(employees);
    }

    /**
     * 批量删除员工
     * 注意：有部门的员工不可以被删除
     * 
     * @param ids 员工ID列表（JSON数组格式）
     * @return 操作结果
     * 
     * @apiNote 请求示例：
     * DELETE /employee/batch
     * [1, 2, 3]
     */
    @DeleteMapping("/batch")
    public R batchDeleteEmployee(@RequestBody List<Long> ids) {
        return employeeService.batchDeleteEmployee(ids);
    }

    /**
     * 统计各部门人数
     * 返回每个部门的名称和员工数量
     * 
     * @return 统计结果，包含部门名称和员工数量
     * 
     * @apiNote 请求示例：GET /employee/stats/count
     * 返回格式：
     * {
     *   "code": 200,
     *   "data": [
     *     {"deptName": "技术部", "employeeCount": 10},
     *     {"deptName": "人事部", "employeeCount": 5}
     *   ]
     * }
     */
    @GetMapping("/stats/count")
    public R selectDeptEmployeeCount() {
        return employeeService.selectDeptEmployeeCount();
    }

    /**
     * 统计各部门最高薪水员工
     * 返回每个部门中薪水最高的员工信息
     * 
     * @return 统计结果，包含部门名称、员工姓名、最高薪水
     * 
     * @apiNote 请求示例：GET /employee/stats/maxSalary
     * 返回格式：
     * {
     *   "code": 200,
     *   "data": [
     *     {"deptName": "技术部", "employeeName": "张三", "maxSalary": 12000.00},
     *     {"deptName": "人事部", "employeeName": "李四", "maxSalary": 8000.00}
     *   ]
     * }
     */
    @GetMapping("/stats/maxSalary")
    public R selectDeptMaxSalaryEmployee() {
        return employeeService.selectDeptMaxSalaryEmployee();
    }

    /**
     * 统计各部门薪水总和
     * 返回每个部门的薪水总额
     * 
     * @return 统计结果，包含部门名称和薪水总和
     * 
     * @apiNote 请求示例：GET /employee/stats/totalSalary
     * 返回格式：
     * {
     *   "code": 200,
     *   "data": [
     *     {"deptName": "技术部", "totalSalary": 100000.00},
     *     {"deptName": "人事部", "totalSalary": 40000.00}
     *   ]
     * }
     */
    @GetMapping("/stats/totalSalary")
    public R selectDeptTotalSalary() {
        return employeeService.selectDeptTotalSalary();

    }
} 